Autogenerated HTML docs for v1.7.12-rc0
diff --git a/git-credential.html b/git-credential.html index b0765d0..2a249ef 100644 --- a/git-credential.html +++ b/git-credential.html
@@ -684,21 +684,19 @@ <h2 id="IOFMT">INPUT/OUTPUT FORMAT</h2> <div class="sectionbody"> <div class="paragraph"><p><tt>git credential</tt> reads and/or writes (depending on the action used) -credential information in its standard input/output. These information +credential information in its standard input/output. This information can correspond either to keys for which <tt>git credential</tt> will obtain the login/password information (e.g. host, protocol, path), or to the actual credential data to be obtained (login/password).</p></div> -<div class="paragraph"><p>The credential is split into a set of named attributes. -Attributes are provided to the helper, one per line. Each attribute is +<div class="paragraph"><p>The credential is split into a set of named attributes, with one +attribute per line. Each attribute is specified by a key-value pair, separated by an <tt>=</tt> (equals) sign, followed by a newline. The key may contain any bytes except <tt>=</tt>, newline, or NUL. The value may contain any bytes except newline or NUL. In both cases, all bytes are treated as-is (i.e., there is no quoting, and one cannot transmit a value with newline or NUL in it). The list of attributes is terminated by a blank line or end-of-file. -Git will send the following attributes (but may not send all of -them for a given credential; for example, a <tt>host</tt> attribute makes no -sense when dealing with a non-network protocol):</p></div> +Git understands the following attributes:</p></div> <div class="dlist"><dl> <dt class="hdlist1"> <tt>protocol</tt> @@ -744,13 +742,29 @@ The credential’s password, if we are asking it to be stored. </p> </dd> +<dt class="hdlist1"> +<tt>url</tt> +</dt> +<dd> +<p> + When this special attribute is read by <tt>git credential</tt>, the + value is parsed as a URL and treated as if its constituent parts + were read (e.g., <tt>url=https://example.com</tt> would behave as if + <tt>protocol=https</tt> and <tt>host=example.com</tt> had been provided). This + can help callers avoid parsing URLs themselves. Note that any + components which are missing from the URL (e.g., there is no + username in the example above) will be set to empty; if you want + to provide a URL and override some attributes, provide the URL + attribute first, followed by any overrides. +</p> +</dd> </dl></div> </div> </div> <div id="footnotes"><hr /></div> <div id="footer"> <div id="footer-text"> -Last updated 2012-07-09 13:33:29 PDT +Last updated 2012-07-23 21:34:17 PDT </div> </div> </body>
